home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xt / XtConvert.z / XtConvert
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXXtttt))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))      XXXXttttCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtConvert, XtDirectConvert - invoke resource converters
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           void XtConvert(_w, _f_r_o_m__t_y_p_e, _f_r_o_m, _t_o__t_y_p_e, _t_o__r_e_t_u_r_n)
  13.               Widget _w;
  14.               String _f_r_o_m__t_y_p_e;
  15.               XrmValuePtr _f_r_o_m;
  16.               String _t_o__t_y_p_e;
  17.               XrmValuePtr _t_o__r_e_t_u_r_n;
  18.  
  19.           void XtDirectConvert(_c_o_n_v_e_r_t_e_r, _a_r_g_s, _n_u_m__a_r_g_s, _f_r_o_m,
  20.           _t_o__r_e_t_u_r_n)
  21.               XtConverter _c_o_n_v_e_r_t_e_r;
  22.               XrmValuePtr _a_r_g_s;
  23.               Cardinal _n_u_m__a_r_g_s;
  24.               XrmValuePtr _f_r_o_m;
  25.               XrmValuePtr _t_o__r_e_t_u_r_n;
  26.  
  27.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  28.           _a_r_g_s      Specifies the argument list that contains the
  29.                     additional arguments needed to perform the
  30.                     conversion (often NULL).
  31.  
  32.           _c_o_n_v_e_r_t_e_r Specifies the conversion procedure that is to be
  33.                     called.
  34.  
  35.           _f_r_o_m      Specifies the value to be converted.
  36.  
  37.           _f_r_o_m__t_y_p_e Specifies the source type.
  38.  
  39.           _n_u_m__a_r_g_s  Specifies the number of additional arguments
  40.                     (often zero).
  41.  
  42.           _t_o__t_y_p_e   Specifies the destination type.
  43.  
  44.           _t_o__r_e_t_u_r_n Returns the converted value.
  45.  
  46.           _w         Specifies the widget to use for additional
  47.                     arguments (if any are needed).
  48.  
  49.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  50.           The _X_t_C_o_n_v_e_r_t function looks up the type converter
  51.           registered to convert from_type to to_type, computes any
  52.           additional arguments needed, and then calls _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t.
  53.           _X_t_C_o_n_v_e_r_t has been replaced by _X_t_C_o_n_v_e_r_t_A_n_d_S_t_o_r_e.
  54.  
  55.           The _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t function looks in the converter cache to
  56.           see if this conversion procedure has been called with the
  57.           specified arguments.  If so, it returns a descriptor for
  58.           information stored in the cache; otherwise, it calls the
  59.           converter and enters the result in the cache.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXXtttt))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))      XXXXttttCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           Before calling the specified converter, _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t sets
  75.           the return value size to zero and the return value address
  76.           to NULL.  To determine if the conversion was successful, the
  77.           client should check to_return.address for non-NULL.
  78.           _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t has been replaced by _X_t_C_a_l_l_C_o_n_v_e_r_t_e_r.
  79.  
  80.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.           XtAppAddConverter(3Xt), XtStringConversionWarning(3Xt),
  82.           XtConvertAndStore(3Xt), XtCallConverter(3Xt)
  83.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  84.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.